USPS Pricing Engine Web Services 


December 4, 2015 


Summary 


This is the Domestic and International Pricing Engine Web Services (version 11.3.0.0) for the January 


2016 Release. The following is a list of Enhancements included in this release. 


Domestic Pricing Engine 


BNS 426 - PM MEPT Change Price Values 


Change prices in existing price cells in all classes of mail for Competitive 


BNS 339 - Eliminate Priority Mail Express Flat Rate Box 


Priority Mail Express Flat Rate Box has been turned off for the following customer maps: 





008B3 


Click-N-Ship 


Commercial Base 


CNS 





009B6 


Click-N-Ship for Business 


Commercial Base 


Permit Imprint 





009P6 


Click-N-Ship for Business 


Commercial Plus 


Permit Imprint 





009B5 


Click-N-Ship for Business 


Commercial Base 


Metered 





015B4 


EASR 


Commercial Base 


Postage Stamps 





015P4 


EASR 


Commercial Plus 


Postage Stamps 





015R4 


EASR 


Retail 


Postage Stamps 





011B6 


eVS 


Commercial Base 


Permit Imprint 





011P6 


eVS 


Commercial Plus 


Permit Imprint 





007B7 


PC Postage 


Commercial Base 


PC Postage 





012R4 


PASS 


Retail 


Postage Stamps 





018B6 


PFSC 


Commercial Base 


Permit Imprint 





004B4 


WebTools 


Commercial Base 


Postage Stamps 





004P4 


WebTools 


Commercial Plus 


Postage Stamps 





004R4 


WebTools 


Retail 


Postage Stamps 





014R4 








Postage Price Calculator 





Retail 





Postage Stamps 





BNS 351 - Eliminate Priority Mail Regional Rate Box C 


Priority Mail Regional Rate Box C has been turned off for the following customer maps: 





008B3 


Click-N-Ship 


Commercial Base 


CNS 





009B6 


Click-N-Ship for Business 


Commercial Base 


Permit Imprint 





009P6 


Click-N-Ship for Business 


Commercial Plus 


Permit Imprint 





009B5 


Click-N-Ship for Business 


Commercial Base 


Metered 





015B4 


EASR 


Commercial Base 


Postage Stamps 











015P4 


EASR 





Commercial Plus 





Postage Stamps 
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EASR 


Retail 


Postage Stamps 





eVS 


Commercial Base 


Permit Imprint 





eVS 


Commercial Plus 


Permit Imprint 





PC Postage 


Commercial Base 


PC Postage 





PASS 


Retail 


Postage Stamps 





SBP 


Commercial Base 


Permit Imprint 





SBP 


Commercial Plus 


Permit Imprint 





WebTools 


Commercial Base 


Postage Stamps 





WebTools 


Commercial Plus 


Postage Stamps 











Postage Price Calculator 





Retail 





Postage Stamps 





BNS 416 - Eliminate Critical Mail 
Priority Mail Letter Critical Mail, Priority Mail Letter Critical Mail with Signature, Priority Mail Flat Critical 
Mail, Priority Mail Flat Critical Mail with Signature, have been turned off for the following customer 


maps: 


BNS 337 - Eliminate First-Class Package Service CPP Prices 


1. 





PASS 


Retail 


Postage Stamps 





SBP 


Commercial Plus 


Permit Imprint 











Postage Price Calculator 





Retail 





Postage Stamps 





First-Class Package Service Commercial Plus Prices will no longer be returned for the following 


customer maps: 





009P6 


Click-N-Ship for Business 


Commercial Plus 


Permit Imprint 





015P4 


EASR 


Commercial Plus 


Postage Stamps 





011P6 


eVS 


Commercial Plus 


Permit Imprint 





022P6 


SBP 


Commercial Plus 


Permit Imprint 








004P4 





WebTools 





Commercial Plus 





Postage Stamps 





First-Class Package Service Commercial Base Prices will now be returned for weights greater 











than 13 oz. and less than 16 oz. 


BNS 341 - Ground Product Strategy and New Name 


Renamed the following Mail Services 





Mail Service ID Was Now 

73 Standard Post USPS Retail Ground™ 
71 Parcel Select Nonpresort Parcel Select Ground™ 
Note: the Mail Service IDs and Group Codes have not been changed 























BNS 343 - Eliminate Parcel Select ONDC Presort and NDC Presort 


This will have no effect on the SDK systems and is only included to keep SDK databases in sync. 
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BNS 330 - Eliminate PRS NDC 
This will have no effect on the SDK systems and is only included to keep SDK databases in sync. 


BNS 316 - Click-N-Ship Retail Prices Not Commercial Base 
1. Anew customer map for Click-N-Ship was added 
Name: 008R3 
The 008R3 customer map matches the 008B3 customer map with the following exceptions 
a. Only retail “R” prices are returned 
b. Regional Rate Box A, B and C are not returned 
2. Anew customer map for Mobile was added 
a. Name: 023C4 
b. The 023C4 customer map contains pricing for both Retail and Click-N-Ship. The Price 
Type “R” is used for to indicate that the Mail Service is available at the Retail counter for 
the Price contained with the same object. The Price Type “O” is used for to indicate that 
the Mail Service is available at on Click-N-Ship for the Price contained with the same 
object. 
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Examples: 





i- MaxWeight 
i- MinWeight 
H- ExtraPostage Services 


Note: “C” is a new Price Type used only for Calculator Customs Maps. 


International Pricing Engine 


BNS 426 - PM MEPT Change Price Values 
Change prices in existing price cells in all classes of mail for Competitive 


BNS 357 - Priority Mail International Insurance Included 
1. Priority Mail Express International and Priority Mail International will now return $0.00 for the 
cost for Insurance when the Declared Value is $200.00 or less. 
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The following new Contain Type has been added to indicate that the mail piece contains only 
Nonnegotiable Documents. When it is indicated that the mail piece contains only Nonnegotiable 
Documents the Pricing Engine will not return Insurance as an extra service. 





Key 


Description 





NonnegotiableDocument 








The mail piece contains only Nonnegotiable Document(s) 





The following new Attributes have been added to any Mail Service that allows Insurance. 





Key 


Description 





InclnceNonnegotiableDoc 


Included Insurance Nonnegotiable Document 








InclnceMerchandise 





Included Insurance Merchandise 





BNS 377 - Expand PMI & PMEI Rate Group Structure to Regions 
The Pricing Engine will return Regional based pricing for Priority Mail Express International Flat Rate and 
Priority Mail International Flat Rate products. 


BNS 380 - New Designated Operator for Bonaire, St. Eustatius, Saba 
1. Added a new parent country: 





Name 


Bonaire, Sint Eustatius, and Saba 





Country ID 


12318 





Code 


BQ 








Country Number 


535 








Re-parented “Bonaire”, “St. Eustatius” and “Saba” to the new country “Bonaire, St. Eustatius, 
and Saba” with the following changes 





County ID | Name 


Code Country Number 





10299 Bonaire (Bonaire, Sint Eustatius, and Saba) BQ 535 





10303 Saba (Bonaire, Sint Eustatius, and Saba) BQ 535 

















10304 Sint Eustatius (Bonaire, Sint Eustatius, and Saba) 535 





Updated Country Regulations for “Curacao” 


Added Country Regulations for “Bonaire, Sint Eustatius, and Saba” 


BNS 453 - Expand Electronic USPS Delivery Confirmation 
Added “USPS Delivery Confirmation Electronic” to “Slovak Republic”, “Turkey”, “Lebanon” and 
”Norway”. 


BNS 465 - CNS Pays Retail Prices for PMEI, PMI, GXG, & FCPIS 


1. Anew customer map for Click-N-Ship was added 


Name: 008R3 


The 008R3 customer map matches the 008B3 customer map with the following exceptions 
a. Only retail “R” prices are returned 
2. Anew customer map for Mobile was added 
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Name: 023C4 


The 023C4 customer map contains pricing for both Retail and Click-N-Ship. The Price 


Type “R” is used for to indicate that the Mail Service is available at the Retail counter for 


the Price contained with the same object. The Price Type “O” is used for to indicate that 


the Mail Service is available at on Click-N-Ship for the Price contained with the same 


object. 
GXG will not be returned 


BNS 466 - Eliminate PMEI Flat Rate Box 


Priority Mail Express International Flat Rate Box has been turned off for the following customer maps: 





008B3 | Click-N-Ship Commercial Base 


CNS 





009B5 | Click-N-Ship for Business Commercial Base 


Metered 





011B6 eVS Commercial Base 


Permit Imprint 





011P6 eVS Commercial Plus 


Permit Imprint 





007B7 PC Postage Commercial Base 


PC Postage 





004B4 WebTools Commercial Base 


Postage Stamps 





004P4 WebTools Commercial Plus 


Postage Stamps 





004R4 WebTools Retail 


Postage Stamps 





014R4 Postage Price Calculator Retail 














Postage Stamps 





Domestic and International Pricing Engines 


BNS 439 - Visibility for Pharmaceuticals and Critical Shipments 
The Domestic and International Pricing Engines have been updated to support the "Pharmaceuticals” 


and "MedicalSupplies” content types for the eVS customer types (011B6 and 011P6). For the eVS 


customer types, specifying either "Pharmaceuticals” or "MedicalSupplies” as the content type will result 


in only the following mail services being returned: 


Domestic: 
e Priority Mail 
e Priority Mail Express 
e Frist-Class Mail Parcel 
e First-Class Package Service 
e Parcel Select 


International 
e Priority Mail International 
e Priority Mail Express International 
e First-Class Package International Service 
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CR 5661 - BNS 439 - Add Pharmaceuticals and MedicalSupplies to MetroPost 
Update the Domestic Pricing Engine to support the "Pharmaceuticals" and "MedicalSupplies" content 
types for the Metro Post customer types (016R4). 


BNS 426 - The Pricing Engine will be establishing a new interface to support 
Discounts, Fees and Surcharges 

A new interface has been added to the Domestic and International Pricing Engines to support discount, 
fees and surcharges pricing. 


Method Signature 
GetMailingFees(in mailingFeeRequest : MailingFeeRequest) : MailingFee 


Description 

The method is used to get the Mailing Fee for a specified key. The Mailing Fee Request can contain a list 
of keys or a single key path with dots “.” delimiters. If the full key path is not specified the result will be 
in the form of a tree with the end of each brunch containing the price, cost, value key, and value limits. 
If the QueryValue is specified the results will be filtered using the value limits. If the value key of all the 
result mailing fee matches, the value is applied to calculate the Cost. 


Request Key Example: 
AddressCorrection.Electronic.FCM 


or 


AddressCorrection 
Electronic 
FCM 


Query Value Example: 
Request: 


QueryValue = 10 

FeeKey = “StampedEnvelopes.PlainStampedEnvelopes.Basic.10.Each” 
Results: 

Price = 0.13 

Cost = 1.30 


URLs 


Domestic 


http://dbservices.usps.com/PricingServices.asmx 


International 


http://ibservices.usps.com/PricingServices.asmx 
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Reported Defects 





ID Title Status 





5331 | BNS 316 - CNS Client Mapping 008B3 should return an error Corrected 





5332 | BNS 341 - Ground Products Strategy and New Name Corrected 





5466 | BNS 426 - PC_MEPT_Change Price Values - Incorrect price for GXG Insurance Corrected 





5550 | BNS 377 - PMI Small FRB not showing up for countries in group 6 Corrected 





5588 | PMEI Padded FRE is not being returned for Tonga Corrected 





5586 | BNS 439 - When requesting Pharmaceuticals or MedicalSupplies in the Content Corrected 
tag the Insurance Extra Service is not return 








5666 | BNS 426 - PC_MEPT_Change Price Values - PMI Flat Rate box prices incorrect for Corrected 
DVD and Large Video Flat Rate - Verify correction 











Bug 5331 - BNS 316 - CNS Client Mapping 008B3 should return an error 


Steps to Reproduce 

When requesting "GetServicesWith Pricing" using Client Map 008B3, valid responses are returned; 
expected an exception/error "Customer Type 008B3 is invalid". Please see email with screen shots from 
the test tool. 


Acceptance Criteria 
When requesting information from any Rate Engine method using Client Map 008B3, an exception/error 
should be returned “Customer Type 008B3 is invalid”. 


Bug 5332 - BNS 341 - Ground Products Strategy and New Name 


Steps to Reproduce 

For Parcel Select NPS and Parcel Select Ground the Rate Engine returns “PARCEL SELECT GROUND”. This 
verbiage is put on the label banner. The requirements received from the business state the following 
should be returned: 


e For Parcel Select NPS and Parcel Select Ground 

o "USPS PARCEL SELECT GND" should be returned. 
e For Standard Post or Retail Ground 

o "USPS RETAIL GROUND" should be returned. 


J. Salerno 10/20/15 per email from Lizbeth Dobbins dated 10/20/15: 


| have already responded to James to let him know there is no conflict. As info for the rest of you on the 
email stream-- 


1. Ground is GND on the label for “space” issues. GND is the appropriate abbreviation when there 
is no room. 
2. USPS must be ona shipping label—it doesn’t change what we are coding. 
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3. The marks are in the process of being registered. Legal would not have approved them moving 
forward if there was an issue. 


With the above being stated it was decided the WebTools Team will put the Label Banner Text on the 
Label as requested by the business. The Rate Engine will send the names as stated in the MLOC along 
with the TM as follows: 


e Renaming Parcel Select Nonpresort as Parcel Select Ground™ (PSG) 
e Standard Post as USPS Retail Ground™ 


Acceptance Criteria 
The requirements received from the business state the following should be returned: 


e For Parcel Select NPS and Parcel Select Ground 

o "Parcel Select Ground™" should be returned. 
e For Standard Post or Retail Ground 

o "USPS Retail Ground™" should be returned. 


Bug 5466 - BNS 426 - PC_MEPT_Change Price Values - Incorrect price for GXG 
Insurance 


Steps to Reproduce 
The price for GXG insurance 1 to 100 should be 0 


Acceptance Criteria 
When between $1.00 and $100.00 is enter for GXG insurance the price of 0 is returned. 


Bug 5550 - BNS 377 - PMI Small FRB not showing up for countries in group 6 
The Priority Mail International® Small Flat Rate Box not available for Australia/New Zealand (Zone 6) 


Bug 5588 - PMEI Padded FRE is not being returned for Tonga 
Priority Mail Express International™ Padded Flat Rate Envelope not available for Tonga 


Bug 5586 - BNS 439 - When requesting Pharmaceuticals or MedicalSupplies in 


the Content tag the Insurance Extra Service is not return 
When requesting Pharmaceuticals or MedicalSupplies in the Content tag the Insurance Extra Service is 
not return. 


Bug 5666 - BNS 426 - PC_MEPT_Change Price Values - PMI Flat Rate box prices 
incorrect for DVD and Large Video Flat Rate - Verify correction 


Steps to Reproduce 
1. Navigate to http://ircalc-cat4.usps.com:9080/ 
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In the Select a Destination drop-down, select Australia. 

Enter 0 for the Item's Value. 

Select the radio button for Package in the Select Shape section. 

When prompted for Enter Weight, enter 2 pounds. 

Click on the Continue button. 

Select Priority Mail International Options to expand the PMI section. 

You will notice that the the postage price for the PMI DVD Flat Rate priced box and the Large 
Video Flat Rate priced box is incorrect as the calculator is returning the postage for PMI 
Envelopes. 


Acceptance Criteria 
In the reproduction steps, the PMI DVD Flat Rate priced box and the Large Video Flat Rate priced box 


should report $34.95. This is the price for PMI Flat Rate priced boxes in group 6. 


All prices for PMI DVD and Large Video Flat Rate priced boxes should match the PMI Small Flat Rate 
priced boxes rates for the specified weight and price group. 
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